Contents
WinPrint 1.5

Copyright © 1989-1994 Charles E. Kindel, Jr.

Portions Copyright © 1987-1994 Microsoft Corp.

"A unique solution for the control of printing ASCII files using

the power of the Microsoft Windows printer interface."

- Howard Sobel, WUGNET

Limited Warranty

WinPrint is a shareware application for Windows 3.1 that allows easy printing of ASCII text files from within the Windows environment.  For information on registering your copy of WinPrint please read the Registration Information section.

Did you know you can register WinPrint online on CompuServe?!?

See Registration Information for instructions.

Overview

Procedures

Main Window Controls

Menu Commands

Drag and Drop

Command Line Interface

Registration Information

Distribution Files

Limited Warranty

Special Thanks

Miscellaneous


Overview

WinPrint is a Windows 3.1 utility for printing ASCII text files easily and efficiently in Windows.  It allows you to easily select the files to print, choose formatting options, and print to any printer supported by the Windows environment.

WinPrint provides the following major features:

Spooling

Multiple Columns (or "n pages up")

Headers and Footers

Margin Control

Font Control

Tab and Form Feed Support

Multiple Saved Configuration

Command Line Invocation

On-Line Help

Overview of Fonts

Overview of Printer Drivers


Spooling

WinPrint uses the Windows Print Manager to effectively manage its output.  You can print many files at once and still get other work done on your computer.  WinPrint allows you to select multiple files to be printed as one job or each file can be printed separately.


Multiple Columns (or "n pages up")

You can configure WinPrint to print your files in one or more columns per page.  If you set your printer to print in landscape mode,  and choose 2 columns, you can easily fit two 80 column by 66 line pages on each sheet of paper.  Printing files "2 pages up" can save considerable amounts of paper!


Headers and Footers

Headers and footers can be printed on each page.  They can contain the name of the file, the time and date the file was last revised, the current time and date, and page numbers.


Margin Control

Top, left, bottom, and right margins can be set using either inches or the metric system.


Font Control

WinPrint allows the user to select fonts, point sizes, and print attributes such as bold and italic.  Headers/Footers and the text being printed can use different fonts and attributes.


Tab and Form Feed Support

Many files that you might want to print on your PC contain Tab and Form Feed characters.  WinPrint can be set to convert tab characters to any number of spaces, or to ignore them.  WinPrint also "understands" form feeds and takes appropriate action.


Multiple Saved Configuration

WinPrint can save it's configuration for each type of file you print.  For example you might have one configuration named "SourceCode" that would print your files in landscape mode with 2 pages up.  At the same time you could also have a configuration named "Documentation".  This configuration would be used to print shareware documentation in portrait mode with no margins or headers and footers.


Command Line Invocation

While WinPrint has a carefully crafted user interface that takes full advantage of the Windows Graphical User Interface, all options can be set from the command line.  This enables you to run WinPrint transparently from a other programs such as Microsoft Visual C++ IDE or Wilson WindowWare's Command Post.


On-Line Help

WinPrint is equipped with on-line documentation.  Complete documentation of all features is available at any time with the push of a button or pull of a menu.


Overview of Fonts

There are several types of fonts in Windows, and WinPrint allows you to choose between them.  In order to understand how WinPrint deals with the various types of fonts, a description of fonts is in order.

Types of Fonts

There are three basic types of fonts in Windows: raster, vector, and device.  Raster fonts are fonts that are made up of bitmapped images.  They are usually limited to specific sizes and do not look very good when output at sizes different then those directly supported.  Examples of raster fonts in Windows are Tms Rmn, Helv, MS Sans Serif, and MS Serif.

Vector fonts are fonts that are made up of lines and curves.  They are capable of being output at many sizes, but tend to look poor at very small sizes.  Examples of vector fonts are Roman and Script.  TrueType fonts and other "scalable" fonts can also be considered vector fonts.

Device fonts are fonts that are supported by a hardware device.  They may be raster (in the case of the HP LaserJet II or Epson dot matrix printers) or vector (in the case of Postscript or HP LaserJet III printers).

Proportional vs. Fixed Width Fonts

Beyond the basic font types, there are two other categories of fonts:  Proportional and Fixed Width.

Proportional fonts are also sometimes referred to as Proportionally Spaced or Variable Spaced.  In a proportionally spaced font the width of different characters in the font are different.  For example the letter 'i' is not as wide as the letter 'm'.  Examples of proportional fonts are Tms Rmn, Helv, MS Sans Serif, MS Serif, Times New Roman, and Arial.

Fixed Width fonts are sometimes called Monospaced or Fixed Pitch.  In a fixed width font all characters in the font have the same width. This paragraph is displayed in Courier which is a fixed width font.  Notice the letter 'i' takes up as much horizontal space as the letter 'm'.  Other examples of fixed width fonts are OEMfixed, Line Printer, and most device fonts found in dot matrix printers.

WinPrint only supports fixed pitched fonts for text printing.   Therefore only fixed pitch fonts will be displayed in the Text Options Dialog Box.   WinPrint does support proportional fonts for headers and footers.

Font Sizes

WinPrint, and most word processing software, measure font size in points.  A point is defined as 1/72nd of an inch.  The point size only applies to the height of the font.


Overview of Printer Drivers

Windows provides applications such as WinPrint an easy to use interface to hundreds of different printer models through printer drivers.  You can setup Windows for any number of different printers either when you initially install Windows or by using the Windows Control Panel [image] (CONTROL.EXE).

Unfortunately the quality of the printer drivers shipped with Windows 3.0 varies wildly.  WinPrint attempts to circumvent many of the known bugs in some of the drivers, but there are still problems.  Most of the problems that you may come across with WinPrint are addressed in the Printer Driver Bugs section.  Versions of Windows greater than 3.0a will have printer drivers that are much better across the board.

If you feel that WinPrint is not outputting as you think it should please read the Printer Driver Bugs section before blaming WinPrint.  In many cases there are newer drivers available from either Microsoft or your printer manufacturer.


Printer Driver Bugs

NOTE:  If you are using Windows 3.1 you can ignore this section.  In almost all cases, the quality of the printer drivers in Windows 3.1 is significantly better than in Windows 3.0.  It is strongly recommended that you upgrade to Windows 3.1.

Many Windows 3.0 printer drivers have serious bugs.  This section is an attempt to give you an idea of what drivers are particularly bad, and what you can do to get around the problems caused by the bugs.

The printer drivers listed below as being "buggy" are Windows 3.0 and Windows 3.0a printer drivers.  Your printer manufacturer or Microsoft may have an updated driver at this time.  In instances where a fixed driver is known to be available, note is made below.

Extended Device Mode Bugs

Almost all of the dot matrix printer drivers shipped with Windows 3.0 and 3.0a fail to implement an important feature of Windows 3.0 device drivers, the Extended Device Mode function.  The result of this is that it is impossible for applications to change printer settings such as page orientation or print quality programmatically.  With these drivers, the only way to change these settings is through the Control Panel.  Changes made through the control panel are system wide.

WinPrint has been designed to only change printer settings locally (i.e. changes made in WinPrint do not affect other applications.)  If you use a printer driver that does not implement the Extended Device Mode function you will not be able to change printer settings from within WinPrint.

The following Windows 3.0 printer drivers are known to not implement the Extended Device Mode function:

- All EPSON 9 pin drivers (EPSON.DRV)

- All EPSON 24 pin drivers (EPSON24.DRV)

- All IBM ProPrinter drivers (PROPRINT.DRV)

- All Okidata dot matrix printers

- The Generic Text Only driver (TTY.DRV)

Please note that this is not an exhaustive list of drivers that do not support Extended Device Mode.  You can tell if the driver you are using supports Extended Device Mode if the Options... button in the Print Setup dialog box is enabled.

Low Resolution Font Selection Bugs

Many dot matrix printer drivers do not correctly tell applications what their settings are when they are in their lowest resolution mode.   WinPrint gets around this bug for the most part when you print using Device Fonts.  But if you try to print Vector or Raster fonts you will find that WinPrint uses fonts that are much larger than you asked for.

Typically you will have to put the printer in its lowest resolution mode (120 x 72 on the EPSON drivers, for example) for this to happen.

You can get around this bug by only selecting device fonts or by changing the resolution of the driver in Control Panel to a higher resolution.

Some printer drivers that exhibit this behavior are:

- All EPSON 9 pin drivers (EPSON.DRV)

- All EPSON 24 pin drivers (EPSON24.DRV)

- All IBM ProPrinter drivers (PROPRINT.DRV)

Updated Printer Drivers

In October of 1990 Microsoft released the Supplemental Drivers Library that contained many printer drivers that fixed some of the known bugs.  You can get the SDL by calling Microsoft or you can download updated drivers from the MSOPSYS forum on CompuServe.


Procedures

Starting WinPrint

Selecting Files For Printing

Selecting Fonts

Drag and Drop


Starting WinPrint

WinPrint can be started in any of several ways; from a Program Manager icon, the File Manager, or by another application.

Once WinPrint begins executing several things happen.  First WinPrint checks to see if you are a registered user or not.  If you are not, two windows will appear; one after the other.  The first window gives you information regarding WinPrint such as the version number and registration instructions.  Click on the "Ok" button to continue.

The second window is the Registration Window.  This window is provided to give you an opportunity to enter your registration number if you are registered user.   It also provides a button that will allow you print a registration form that you can send in along with your registration payment.  See Registering WinPrint for more information on registering WinPrint.

After WinPrint checks the registration information, it checks to see if you have used WinPrint before.  If you have, the configuration WinPrint used that last time it was run is loaded.  Otherwise WinPrint sets all options to their Factory Defaults.

WinPrint can also be started with command line options.  See Starting WinPrint with Command Line Options for more information.


Selecting Files For Printing

WinPrint can print several files at once.  The files that will be printed are displayed in the listbox and are placed in the other listbox by using the Select button.

See Command Line Interface


Selecting Fonts

WinPrint allows you to select the font, font size, and font style for both the text and headers and footers of your printouts.  To change the font for the text select the Options.Text... menu item.  To change the font for your headers and footers select the Options.Headers/Footers... menu items.

NOTE:  WinPrint only supports fixed pitch fonts for Text printing.  Thus only fixed pitch fonts will be listed in the Text Options dialog box.

Overview Of Fonts

Overview Of Printer Drivers

See Command Line Interface


Drag and Drop

WinPrint fully supports the Windows 3.1 Drag Drop interface from the FileManager.  This means that you can select files in the File Manager, drag them to the WinPrint window (or icon), and drop them by releasing the mouse button.  If WinPrint is minimized when you drop files on it, WinPrint will begin printing those files immediately.  If WinPrint is not minimized, the files will be added to the Selected Files listbox.

WinPrint has been optimized to work closely with the Windows 3.1 File Manager.  It fully supports drag and drop operations.  In fact, the recommended way for using WinPrint is to set it up with your favorite options, minimize it, and drop files on it at will!  You can even have several copies of WinPrint minimized, each with a separate configuration loaded (see WinPrint Command Line Interface for information on how to start WinPrint with a specific configuration).

Printing From the Windows File Manager

File Associations and the Registration Database


Printing From the Windows File Manager

WinPrint has been optimized to work closely with the Windows 3.1 File Manager.  It fully supports drag and drop operations.  In fact, the recommended way for using WinPrint is to set it up with your favorite options, minimize it, and drop files on it at will!  You can even have several copies of WinPrint minimized, each with a separate configuration loaded (see WinPrint Command Line Interface for information on how to start WinPrint with a specific configuration).

You can also print files by choosing the File.Print... menu item.

Drag and Drop


File Associations and the Registration Database

See the Microsoft Windows 3.1 Users Guide for information on setting up Windows so that the File.Print command in the File Manager will print your ASCII files with WinPrint.

Drag and Drop


Main Window Controls

The WinPrint Window contains several buttons, edit controls, and list boxes (controls) for choosing and printing files.

The main window is split into two boxes.  The box on the top allows you to select files and to see what files are selected for printing.  Near the bottom of the main window is a box that WinPrint uses to display useful information about the current settings.

Select file spec Edit Box

Select Button

List Button

Remove Button

Print Selected Files Button

Choose Files List Box

Selected Files List Box

Information Box

Caption

Menu Commands


Select file spec Edit Box

This edit box contains the file specification that is to be either selected for printing or listed.  The file specification in this box affects the operation of both the "Select" and "List" buttons.  If the "Select file spec" edit box contains a file specification with DOS wild cards in it then the "List" button will be enabled.


Select Button

Clicking on this button will cause the file specification contained in the "Select file spec" edit box to be selected for printing.  If the file specification contains wild cards all files in the specified directory matching the wild card will be selected for printing.  If the file specification is simply a filename, then just that file will be selected for printing.  If the "Select file spec" edit box is empty this button will be disabled.


List Button

This button will use the file specification in the "Select file spec" edit box to change to contents of the current file list box (on the left).  The "List" button only has an affect when the file specification has a wild card in it or indicates a change in the current directory or drive.


Remove Button

If any files have been selected and appear in the selected files list box you may use this button to un-select them.  This button will be disabled if there are no selected files.


Print Selected Files Button

After one or more files have been selected (i.e. they appear in the list box to the right) clicking on the "Print Selected Files" button will initiate the printing.  The files will be printed in the order they appear in the selected files list box.


Choose Files List Box

There are two list boxes on WinPrint's main Window.  The one on the left is referred to as the Choose Files list box.  You use this list box in conjunction with the List button, Select button, and File Spec edit control to choose which files you want to print, and to change drives and directories.  This list box is a multiple column list box that can be scrolled horizontally using the scroll bar to view more files and directories.


Selected Files List Box

The list box on the right side of WinPrint's main window is referred to as the Selected Files list box because it contains all of the files you have selected for printing.  Files can be removed from this list box by highlighting them and pressing the Remove button.

When you press the Print Selected Files button all files that are currently listed in the Selected Files listbox will be printed in the order they occur.


Information Box

Along the bottom portion of WinPrint's main window you will notice a box containing information concerning the currently selected fonts, printer, printer orientation, and number of columns.  By double clicking on the boxes within the Information Box you can pop up the appropriate dialog box.


Caption

The WinPrint caption bar indicates the name of the currently loaded configuration.  When changes have been made to the current configuration the "-" character will change to a "*" character.


Menu Commands

File Menu

The File menu allows you to open or save configurations, change printers, or quit WinPrint.

Open Configuration...

Save Configuration...

Printer Setup...

Exit

Options Menu

The Options menu can be used to change settings.

Text...

Headers and Footers...

Page Layout...

Minimize while printing...

Exit when done printing...

Help Menu

The Help menu provides access to selected main topics in this help file and help on using Windows help.

Contents...

Help on Help...

About...


Open Configuration...

Pressing the OK button opens the configuration selected in the list box, invalidating any current settings.

Pressing the Remove button deletes the configuration selected in the list box.  Note that once you delete a saved configuration it is gone for good.

Pressing the Cancel button exits the dialog box without opening a configuration.

See Command Line Interface


Save Configuration...

This dialog box allows you to save the current options under a configuration name.

Pressing the OK button saves the current configuration under the name appearing in the Configuration Name edit control.

Pressing the Remove button deletes the configuration selected in the list box.  Note that once you delete a saved configuration it is gone for good.

Pressing the Cancel button exits the dialog box without opening a configuration.

The Save Current Printer with Configuration checkbox allows you to specify if the current printer will be saved with the configuration.  If this check box is checked then whenever the configuration is opened the printer that was currently selected at the time of the save will become selected.

See Command Line Interface


Printer Setup...

This dialog box allows you to change the current printer and/or change printer specific settings.  For example if you use a HP LaserJet IIID printer, this dialog box will allow you to set the printer up for duplex printing.

Many Windows 3.0 printer drivers do not fully support the functionality required by WinPrint for changing printer settings locally.  If you are using one of these drivers you will not be able to change settings from this menu item.  Use Control Panel instead.  For more information see Printer Driver Bugs

Note that when you change the printer with this command you do not change the Windows default printer.


Exit

Choosing File Exit will terminate WinPrint.  If you have an changed any settings WinPrint will ask if you wish to save the list before exiting.


Text...

If you choose the Options.Text menu item you will be presented with a dialog box that will allow you to change the text font and margins.  The text font is the font used by WinPrint when printing the actual text of your files.

WinPrint measures it's page margins from the edge of what is called the "logical page" or "printable page".  Most printer drivers automatically force a 1/8" to 1/4" margin from the physical page edge.  For example the HP LaserJet II driver only allows output within approximately 1/4" margins.  In this case when WinPrint's margins are all set to 0, you will get a .25" margin.

Within this dialog box you can tell WinPrint to measure in inches or centimeters by checking the appropriate radio button.

WinPrint will expand tabs according to the settings in this dialog box.  If the Expand Tabs check box is checked then WinPrint will expand each tab character it finds in the input file to the number of characters specified in the "Spaces" edit control.  Unlike previous versions of WinPrint, version 1.5 actually sets tab stops every n spaces across the page, where n is the number of spaces specified.

IMPORTANT NOTE:

It is important to note that WinPrint 1.x does fully support the printing of your text with non-fixed pitched fones (also called Proportional fonts).  By default, WinPrint will not allow you to choose any fonts for text printing that are not fixed-pitch (such as Courier, Courier New, or Line Printer).  If you want to try printing your files with proportional fonts use INIedit or your favorite editor to edit the WINPRINT.INI file, adding the following entry to the [WinPrint - Main]] section:

FixedPitchOnly=0

Note WinPrint may not work as you expect if you set the FixedPitchOnly switch to 0.   WinPrint simply was not designed to handle printing using proportionally spaced fonts.   Sorry.

For information on choosing a font see Selecting Fonts.

See Command Line Interface


Headers and Footers...

If you choose the Options.Headers/Footers... menu item you will be presented with a dialog box that will allow you to change header and footer options and formatting.  In this dialog box you can select whether you want headers and footers and what you want to appear in the headers and footers.  You can also use the font selection controls to select the font you want to use for the headers and footers.

Headers and footer scan be composed of the name of the file being printed, the date and time that file was last modified or the date and time of printing, and the current page number.

The time and dates are formatted according to the settings in the International [image] section of the Windows Control Panel [image].

If the Use Margins Settings check box is checked, headers and footers will be printed within the currently set left and right margins.  If the check box is not set, the headers and footers will be printed across the entire width of the printable page.

See Command Line Interface


Page Layout...

This dialog box allows you to specify the layout of the page including the number of columns and whether the page is printed in landscape or portrait mode.

See Command Line Interface


Minimize while printing

If this menu item is checked WinPrint will minimize (iconize) itself as soon as it begins printing. This allows you to automatically get WinPrint out of your way while it is printing.

See Command Line Interface


Exit when done printing

This menu item controls whether or not WinPrint will close itself (quit) after it has finished printing the selected files.  If this item is checked when the "Print Selected Files" button is pushed, WinPrint will automatically close when it has finished printing the selected files.

See Command Line Interface


Print each file as a separate job

This menu item allows you to specify whether WinPrint will print each file listed in the Selected Files listbox as separate jobs or as one job.  Some printer drivers are better at handling large jobs (when this item is not checked) than others.  In most cases WinPrint will be faster if this item is not checked.

See Command Line Interface


Contents menu item
Contents

This menu item brings up the WinHelp utility and provides help on how to use WinPrint.


Help on Help

This menu item brings up the WinHelp utility and provides help on using WinHelp.


About...

This menu item pops up the WinPrint about box.  This is useful for finding the version of WinPrint and your registration information.


Command Line Interface

One of WinPrint's most useful features is its ability to be completely controlled from the command line.

Typically, Windows applications are started by double-clicking on the file name in the File Manager or an icon in the Program Manager.  There are several utilities available that can either replace or supplement the standard Windows 3.0 File and Program Managers for launching applications.  Many of these have the ability to launch applications using icons or menus.  Wilson WindowWare's Command Post is a good example of such a product.

WinPrint's command line options allow you to easily integrate WinPrint into one of these products with complete flexibility.  The Command Line Samples section gives examples WinPrint command lines for the Windows Program Manager, Command Post, and the Windows 3.1 Registration Database.

Command Line Syntax

Command Line Options

Command Line Samples


Command Line Syntax

The following syntax and rules are used by WinPrint when invoked from the command line.

»	All options must be prefixed with a slash ("/").  Anything on the command line that is not prefixed with a slash will be interpreted as a filespec.

»	Angle Brackets ("<" and ">") delimit required arguments.  For example the Text font point size option, /TP:<n>, requires an integer value following the colon (":"):

/TP:10

This would tell WinPrint to use a 10pt font size.  Note the angle brackets are not included on the command line.

»	Square Brackets ("[" and "]") are used to delimit optional arguments. An ellipsis ("...") indicates that the previous argument may be repeated. For example the standard usage for WinPrint is

[/opt1 [/opt2]...] [filespec1 [filespec2]...]

Thus zero or more options may be specified, followed by zero or more filespecs.

»	Curly Braces ("{" and "}") delimit an argument that is required but may have two or more possible values. Each possible value is listed within the curly braces. One,  and only one, of the values may be used for each option.  For example the /C{+,-} option may take either of the following forms, but not both:

WinPrint /C+

WinPrint /C-

Note that the curly braces are not included on the command line.

The following is the general syntax for starting WinPrint from the command line:

WINPRINT [/opt1 [/opt2]...] [filespec1 [filespec2]...]

Command Line Options

Command Line Samples


Command Line Options

AutoStart

Begin printing the specified files as soon as WinPrint opens.

/GO

If this options is specified on the command line, WinPrint will begin sending the selected files to the printer immediately.  This is very useful when starting WinPrint via a program manager such as Command Post.

Use Config

Use a previously saved configuration.

/S:<configuration name>

Where <configuration name> is the name of a configuration saved with the File.Save Setup... menu item.  All command line options, except /GO, that precede the /S: option will be ignored.  Options specified after the /S: option will override the appropriate setting within the configuration specified.

If the configuration name contains spaces it must be enclosed in quotes.

AutoClose

Automatically close WinPrint when it is finished printing all of the specified files.

/C{+,-}

This option duplicates the checkbox in the WinPrint main window labeled Close when done.  Plus (+) means checked/on, minus (-) means unchecked/off.

Minimize

Minimize the WinPrint window while it is printing the specified files,

/M{+,-}

This option duplicates the checkbox in the WinPrint main window labeled Minimize while printing.  Plus (+) means checked/on, minus (-) means unchecked/off.

Unit of Measurement

Specifies the unit of measurement used when specifying margins and column spacing.

/U:{IN,CM}

For each of the margin switches given below, n is a real number specifying units of measurement in either inches or centimeters as determined by the /U:{IN,CM} option.

The /U: option must precede any of the margin options on the command line.  If it does not, the default unit setting will be used.

Top Margin

Specifies the value for the top margin.

/MT:<n>

Left Margin

Specifies the value for the left margin.

/ML:<n>

Bottom Margin

Specifies the value for the bottom margin.

/MB:<n>

Right Margin

Specifies the value for the right margin.

/MR:<n>

Text Font Facename

Specifies the facename of the font to be used when printing the text of the specified files.

/TF:<facename>

<facename> specifies the name of the font that the text being printed will appear in.  If the currently selected printer does not support the specified font name, you may get unpredictable results.

If a font name contains spaces it must be enclosed in quotes.

Text Font Pointsize

Specifies the size of the font to be used when printing the text of the specified files in points.

/TP:<n>

If the current printer does not support the specified point size, WinPrint will select the closest available size.

Text Font Style

Specifies the style of the font used when printing the text of the specified files.

/TS:{[I][B],N}

This option allows you to select text attributes for the text being printed. You may specify any combination of [I]talic or [B]old.  If you specify [N]ormal the text will be printed with no attributes.

Header/Footer Font Facename

Specifies the facename of the font to be used when printing the headers and footers of the specified files.

/HF:<fontname>

Where <fontname> specifies the name of the font for the headers and footers (if activated).  If the currently selected printer does not support the specified font name, you may get unpredictable results.

Header/Footer Font Pointsize

Specifies the size of the font to be used when printing the headers and footers of the specified files in points.

/HP:<n>

If the current printer does not support the specified point size, WinPrint will select the closest available size.

Text Font Style

Specifies the style of the font used when printing the headers and footers of the specified files.

/HS:{[I][B],N}

This option allows you to select text attributes for the text being printed. You may specify any combination of [I]talic or [B]old.  If you specify [N]ormal the text will be printed with no attributes.

Header Options

Specifies the format of the header printed at the top of each page.

/H:{[F][N][{P,R}],-}

Using this option you can control what you want to appear in your headers.  You may specify any combination of [F]ilename, page [N]umber, and date [P]rinted/date [R]evised.  If you specify "-" headers will be turned off.

Footer Options

Specifies the format of the footer printed at the bottom of each page

/F:{[F][N][{P,R}],-}

Using this option you can control what you want to appear in your footers.  You may specify any combination of [F]ilename, page [N]umber, and date [P]rinted/date [R]evised.  If you specify "-" footers will be turned off.

Fit Headers/Footers to Margins

Specifies that the Header/footers will use the current left and right margin settings.

/HM{+,-}

WinPrint can print headers and footers in one of two ways: within the left and right margin settings or flush with the edge of the page.  If you specify /HM+, headers and footers will be printed within the current left and right margin settings.  If you specify /HM-, headers and footers will be printed without left and right margins.

Command Line Options No Longer Supported


Command Line Samples

This section contains examples of how to start WinPrint using the Program Manager included with Windows 3.0 or with Morrie Wilson's Command Post.  If you are using another product to launch WinPrint, refer to that product's documentation on the syntax it uses to start applications.

Microsoft Visual C++ IDE Example

To use WinPrint directly from the Microsoft Visual C++ IDE follow the following steps:

1) Create and save a WinPrint configuration named Source Code.

2) Add WinPrint to your MSVC++ Tools menu:

- Choose Options.Tools menu in the MSVC++ IDE.

- Press the Add button and enter the path to WINPRINT.EXE.

- Modify the settings as follows:

Command Line:	C:\WINAPPS\WINPRINT.EXE

Menu Text:	Win&Print

Arguments:	-S:Source Code -C+ -M+ $File

Now whenever you choose the Tools.WinPrint menu item, the current file in the IDE will be printed using the configuration named Source Code.

Command Post (Version 7.0) Examples

&Print...

f=FileItemize ("")

t=strcat ("/s:""My std setup"" /m+ /c+ /go ", f) 	        	run("c:\winapps\winprint.exe", t)

drop (t,f)

This would print all files currently highlighted in the Command Post window using the configuration names "My std setup".  WinPrint would start printing automatically while it was minimized and would close when it was done.

Print &Shareware Docs

f=FileItemize("")

t=strcat ("/s:shareware /m+ /c+ /go ", f)

run("c:\winapps\winprint.exe",t)

drop(t,f)

Program Manager Examples

The following examples demonstrate how you could specify a command line in the "Properties" dialog box of program manager.  You could create a program group called "Print" and put several WinPrint icons in that group.  Each icon would have a different command line associated with it.

WINPRINT /S:"Source Code" /GO *.C

Assuming that you have saved a configuration named "Source Code" this would start WinPrint with all of the settings of that configuration.  The /GO option would cause WinPrint to immediately start printing the files in the current directory that match the "_*.C" filespec.

WINPRINT /S:Documents /GO /M+ /C+ winprint.doc

This would print the file winprint.doc, using the configuration settings saved under the name "Documents".  WinPrint would be minimized, would start printing immediately, and would close after it printed the file.

WINPRINT /M+ /C- /U:cm /ML:1.5 /tf:Courier /tp:8 *.c

This would start WinPrint with the Minimize option enabled, the Close option disabled, the Left Margin set at 1.5 centimeters, the text would be printed using the Courier font at an 8pt line height.  All files in the current directory ending with the ".C"  extension would be printed.

WINPRINT /m+ /HS:BI /H:FNP /F:R *.c *.h makefile

In this example WinPrint would print all files in the current directory with either ".C" or ".H" extensions  and the file named "MAKEFILE". Each page would be printed with a header (in Bold and Italic) consisting  of the Filename, page Number, and date Printed. Each  page would also contain a header (also in Bold and Italic) consisting of the date Revised.


Filespecs

Filespecs are any valid DOS file specifications, including the wild card characters "?" and "*".


Registration Information

WinPrint is not and has never been public domain software, nor is it free software.  WinPrint is a commercial application distributed as shareware.

Non-licensed users are granted a limited license (registration) to use WinPrint on a 21-day trial basis for the purpose of determining whether WinPrint is suitable for their needs.  The use of WinPrint, except for the initial 21-day trial, requires registration.  The use of unlicensed (un-registered) copies of WinPrint by any person, business, corporation, government agency or any other entity is strictly prohibited.

A single user license permits a user to use WinPrint only on a single computer.  Licensed users may use the program on different computers, but may not use the program on more than one computer at the same time.

There are two methods for registering WinPrint.   Method one involves using the Shareware Registration System on CompuServe and method two is by mail.

Method One:  Online via CompuServes Shareware Registration Forum

Method one is by far the easiest and fastest way to register shareware.  The process is as follows:

1)	Connect to CompuServe and go to the SWREG forum (type GO SWREG at any ! prompt.

2)	Once you have entered the SWREG forum choose menu item 2 Register Shareware.

3)	Choose 1 Registration ID and enter 546 (which is WinPrints registration ID).

4)	The system will ask you to confirm.

5)	If you confirm, a Compuserve mail message will be sent to me (Charles E. Kindel, Jr. at 71551,1455) indicating that you have registered.   At the same time, your Compuserve account will be charged the $25.00 registration fee.

6)	I will respond to the mail that CompuServe sends with your registration number.   Note that this will be the only notification you will receive with your registration number.  You will not receive one by mail.

Method Two:  By Mail

To register send a check for $25.00 (US Dollars) drawn on a U.S. bank made out to Charles E. Kindel, Jr to:

Charles E. Kindel, Jr.

4522 194th Way N.E.

Redmond, WA  98053

(Note that, as of December 15, 1994, the address above is a new address.)

Important points to remember when registering:

»	The only forms of payment currently accepted are by check for United States dollars drawn on a United States bank (the cost of cashing a check drawn on an international bank is typically $25-$30 which is prohibitively expensive) or cash.  If you do send a check drawn on a U.S. bank, but from an international branch, make sure the check clearly states where a U.S. branch of that bank  is located.

»	You can print a registration form from the Registration Dialog Box or by selecting the registration form topic in WinHelp and using the File.Print... menu item.  Using these forms makes processing orders much easier.

»	Make sure your name and address are clearly legible on the registration form and that you include a first and last name.

The single user registration fee for WinPrint 1.5 is $25 (US Dollars).  Payment of this fee entitles you to:

»	A registration number that will disable the startup shareware reminder windows contained within the program.

»	Technical support via electronic mail.

Diskettes containing the latest version of WinPrint are available for $15.  The most recent version of WinPrint can always be found in the WINSHARE forum on CompuServe

Site licenses for WinPrint are available.  Contact the author for more information.

No one may modify or patch the WinPrint executable and documentation files in any way, including but not limited to decompiling, disassembling, or otherwise reverse engineering the program.

A limited license is granted to copy and distribute WinPrint only for the trial use of others, subject to the above limitations, and also the following:

1)	WinPrint must be copied in unmodified form, complete with the file containing this license information.

2)	The WinPrint product consists of the following files:

WINPRINT.EXE, TDUTIL.DLL, COMMDLG.DLL, README.TXT, and WINPRINT.HLP.  All of these files must be copied in unmodified form.

3)	WinPrint may not be distributed in conjunction with any other product with out a specific license to do so from Charles E. Kindel, Jr.

4)	No fee, charge, or other compensation may be requested or accepted, except as authorized below:

A)	Operators of electronic bulletin board systems (sysops) may make WinPrint available for downloading only as long as the above conditions are met.  An overall or time-dependent charge for the use of the bulletin board system is permitted as long as there is not a specific charge for the download of WinPrint.

B)	Vendors may charge a disk duplication and handling fee, which may not exceed eight dollars.

Distribution Files

WinPrint Registration Form

Limited Warranty

U.S. Government Restricted Rights


Distribution Files

The following files are included with WinPrint:

WINPRINT.EXE

Main WinPrint 1.5 executable.

TDUTIL.DLL

Support Dynamic Link Library.  This file must reside in a directory on your path or in the same directory that WINPRINT.EXE resides in.

COMMDLG.DLL

Support Dynamic Link Library for Microsoft's Common Dialogs.  If you are using Windows 3.0 this file should be copied into your WINDOWS\SYSTEM directory.  If you are using a version of Windows greater than 3.0 or 3.0a this file is already on your system.

WINPRINT.HLP

WinPrint's help file.  This file is used the Windows WinHelp utility to provide online help for WinPrint and should reside in the same directory as WINPRINT.EXE.

README.TXT

This file provides installation instructions and more.  Read it!

All of the above files must be included with all copies of WinPrint distributed!


WinPrint Registration Form

                                WinPrint 1.53

                          ORDER/REGISTRATION FORM

    Remit to:

    Charles E. Kindel, Jr.

    4522 194th Way N.E.

    Redmond, WA  98053

    Checks must be in U.S. funds, payable by a U.S. bank.

    From:

    NAME:          ________________________________________________

                   (Note:  The name of the person who will be using

                           the software MUST be specified!)

    ADDRESS:       ________________________________________________

                   ________________________________________________

                   ________________________________________________

    EMAIL ADDRESS: ________________________________________________

                   (Did you know you can register WinPrint on

                    CompuServe!  See the WinPrint helpfile for

                    instructions.)

    ________ Check here if you want your registration information

             sent to your email address.

    Quantity                                     Unit Price     Total

    ________  WinPrint Single User Registration Fee

                                                 $25.00       _______

                                                 Total:       _______

    Note that WinPrint Version 1.5 has been delivered and accepted by

    the  customer.  Upon receipt of this paid invoice, a registration

    number will be sent.


Limited Warranty

Charles E. Kindel, Jr. guarantees your satisfaction with this product for a period of 90 days from the date of original purchase.  If you are unsatisfied with WinPrint within that time period contact Charles E. Kindel, Jr. via normal or electronic mail for a full refund.

Charles E. Kindel, Jr. warrants that the program will perform in substantial compliance with the documentation supplied with the software product.  If a significant defect in the product is found, the Purchaser may obtain a refund.  In no event will such a refund exceed the purchase price of the product.

EXCEPT AS PROVIDED ABOVE, CHARLES E. KINDEL, JR. DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE PRODUCT.  SHOULD THE PROGRAM PROVE DEFECTIVE, THE PURCHASER ASSUMES THE RISK OF PAYING THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES.  IN NO EVENT WILL CHARLES E. KINDEL, JR. BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE INABILITY TO USE THIS PRODUCT EVEN IF CHARLES E. KINDEL, JR. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Use of this product for any period of time constitutes your acceptance of this agreement and subjects you to its contents.


U.
U.S. Government Restricted Rights

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subdivision (b)(3)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013.  Contractor/manufacturer is Charles E. Kindel, Jr., 22925 N.E. 12th Place, Redmond, WA 98053.


Miscellaneous

Technical Support

Special Thanks

Features No Longer Supported


Technical Support

Technical support for WinPrint is provided to registered users only via electronic mail.

If you are a registered user, you can contact the author for support on CompuServe. Send CompuServe mail to 71551,1455.


Special Thanks

Special thanks to Mike Brehm, Bryan Woodruff, and the entire Microsoft Developer Support team for their invaluable input and testing.  WinPrint could not have been developed without the help of Charles Petzold's book "Programming Windows"; thank you Charles.

WinPrint was written in Microsoft C 6.00, Microsoft Macro Assembler, and the Microsoft Windows Software Development Kit for Microsoft Windows 3.x.


Features No Longer Supported

The following features existed in WinPrint Version 1.32 and lower, but are not available in WinPrint 1.5.   These features were removed because they have either been replaced by other features or are not longer valid in Version 1.5's architecture.

Features

Draft Mode selection from main window.  The check box for selecting draft print has been removed.  You can now set draft mode from the File.Printer Setup menu item.

Command Line Switches No Longer Supported

Select Printer

Specify the printer WinPrint is to use while printing the specified files.

/P:<printer name>

Where <printer name> is the name of a printer that has been installed using the Windows Control Panel program.  If the printer name contains spaces it must be enclosed in quotes.

Draft mode

/D{+,-}

This option duplicates the checkbox in the WinPrint main window labeled Draft Mode.  Plus (+) means checked/on, minus (-) means unchecked/off.


ASCII

ASCII is the code most computers use to represent letters, numbers, and symbols.  ASCII stands for American Standard Code for Information Interchange.  The IBM PC uses the ASCII character set by default, but Windows uses the ANSI character set.


ANSI

ANSI is the code Windows uses to represent letters, numbers, and symbols.   Many of the characters in the ANSI characters set are also in the ASCII character set.


Command line

The command line is the string of text that is passed to all Windows applications upon invocation.  This string is typically made up of parameters that the application knows about.  In WinPrint's case all parameters defined in the Command Line Invocation section are valid.

An example command line for WinPrint might look like this:

WINPRINT.EXE /go /c+ hello.c